home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / dev / misc / MakeTagBase.readme < prev    next >
Text File  |  2001-07-04  |  5KB  |  135 lines
  1. Short:    Make methods and tags bases 1.1 (17.06.01)
  2. Author:   Przemyslaw 'SENSEI' Gruchala (sensei@box43.gnet.pl)
  3. Uploader: Przemyslaw 'SENSEI' Gruchala (sensei@box43.gnet.pl)
  4. Version:  1.1 (17.06.01)
  5. Type:     dev/misc
  6. Replaces: dev/misc/MakeTagBase.lha
  7. Requires: OS 2.0+, any CPU
  8. Keywords: maketagbase redgroup sensei gruchala polska poland
  9.  
  10. WHAT'S THIS?
  11.    This is a small utility to create methods and tags bases for BOOPSI and
  12.    MUI classes, libraries and normal applications.
  13.  
  14. DISCLAIMER
  15.    This  software  is  provided as-is, without warranty of any kind, either
  16.    expressed or implied.  Under no circumstances will the authors be liable
  17.    for  direct,  indirect,  incidental  or  consequential damages either to
  18.    hardware or software or data loss resulting from the use of MakeTagBase.
  19.    The entire risk as to the results of MakeTagBase is assumed by the user.
  20.  
  21. DESCRIPTION
  22.    MakeTagBase can works in two modes:
  23.  
  24.    1) Convert string to bases mode.  When you want create new bases you
  25.    should write for example:
  26.  
  27.    MakeTagBase ID BLAH
  28.  
  29.    and if ID is correct you'll recive for above example:
  30.  
  31.    Converting ID "BLAH"... Base 0x16A94880 TagBase 0x96A94880
  32.  
  33.    Now you can use 'Base' as a method dummy and 'TagBase' as tag base (it's
  34.    'Base' bit or TAG_USER).
  35.  
  36.    2) Convert bases to string mode.  It could be useful if you forgot what
  37.    string you used to create bases or you'd like to check either
  38.     MakeTagBase or existing bases.  Example of usage:
  39.  
  40.    MakeTagBase BASE 0x16A94880
  41.  
  42.    Converting TagBase 0x16A94880... ID "BLAH"
  43.  
  44.    Template of MakeTagBase is ID,BASE=TAGBASE where ID is four character
  45.    long string which contains big case A-Z and 0-9 numbers.  If other
  46.    characters are present or length isn't correct error will occur.
  47.    BASE=TAGBASE is base which you would like to convert to string.  It
  48.    should starts with 0x or $ if it's hexedimal number and with 0-9 if it's
  49.    decimal number.  In other cases error will occur.  You can't use ID and
  50.    BASE=TAGBASE in the same time!
  51.  
  52.    Note that any unused bits like 31 or so aren't touched in this mode.  So
  53.    MakeTagBase BASE 0x16A94880 and MakeTagBase TAGBASE 0x96A94880 are the
  54.    same.
  55.  
  56.     Note that you're not allowed to use f.e.  "0000" as source string
  57.     because it'll be converted to 0!!!
  58.  
  59. HOW IT WORKS?
  60.    In making bases mode it's packing specified string to long word number
  61.    (using it's own packing techniques (which you can learn for request, but
  62.    I doubt that anybody will mail me for it ;) ).  In making string mode
  63.    it's unpacking specified long word number to string.
  64.  
  65. REGISTERED BASES
  66.     Currently "registered" bases are:
  67.  
  68.     - CMDL Base 0x18B1AA80 TagBase 0x98B1AA80 for command.library.
  69.  
  70.     If you're using this utility please contact me and I'll add your base to
  71.     this list, so nobody will use the same bases as you (it's important f.e.
  72.     when you're writing MUI subclasses to create unique bases!!!  F.e.  if
  73.     two or more objects are using the same bases and are placed in one group
  74.     and you'll do method or set attributes of one of these classes on group
  75.     object (group object is setting unknown attributes pased to OM_SET for
  76.     each its children) attribute will be set only for the top object on
  77.     group list!  In other word it'll not do what you want...  Better start
  78.     thinking about it in design state because when everyone is using your
  79.     MCC it's too late to change anything...).  "Registration" is for free,
  80.     so just contact me.  And always upload new MakeTagBases when they're
  81.     released because they could contain more recent list of registered
  82.     bases.
  83.  
  84. FUTURE
  85.     Anything what you want, just contact me ;).
  86.  
  87.     New registered bases and bugs fixes if any.
  88.  
  89. HISTORY
  90.    1.1 (17.06.01):
  91.  
  92.       - First public version.
  93.  
  94.       - Cleanup the source code.  Better error handling (now it's using
  95.         dos.library error codes instead of custom one).
  96.  
  97.       - No stdio printf() routines anymore!  It's using dos.library
  98.         instead.  The result is 2.5 smaller executable file...
  99.  
  100.       - Fixed BASE=TAGBASE mode (which starts not working after using
  101.         dos.library Printf() because I used %c instead of %lc ;).
  102.  
  103.       - BASE=TAGBASE is now accepting several types of tagbases:  if it
  104.         starts with 0x and $ base is in hexedimal format and if first
  105.         character is between 0 and 9 base is in decimal format.
  106.  
  107.         - Compiled with size optimization turned on using SAS/C v6.58.
  108.  
  109.    1.01 (24.08.00):
  110.  
  111.       - Some fixes are made (I don't remember what exactly).
  112.  
  113.    1.0 (??.08.00):
  114.  
  115.       - First internal version.
  116.  
  117. AUTHOR
  118.    Idea, testing and main programmer:
  119.  
  120.       Przemyslaw 'SENSEI' Gruchala (sensei@box43.gnet.pl)
  121.  
  122.    Support:
  123.       Stephen Brookes
  124.  
  125.  
  126. ============================= Archive contents =============================
  127.  
  128. Original  Packed Ratio    Date     Time    Name
  129. -------- ------- ----- --------- --------  -------------
  130.     1671     987 40.9% 17-Jun-01 05:46:30  MakeTagBase.info
  131.     5216    3202 38.6% 17-Jun-01 07:29:40 +MakeTagBase
  132.     4670    2177 53.3% 17-Jun-01 08:13:54 +MakeTagBase.readme
  133. -------- ------- ----- --------- --------
  134.    11557    6366 44.9% 23-Jun-101 01:55:34   3 files
  135.